home *** CD-ROM | disk | FTP | other *** search
/ PC Open 107 / PC Open 107 CD 1.bin / CD1 / INTERNET / COPIA SITI / Getleft / getleft-setup-notcl.exe / {app} / doc / howto.help < prev    next >
Encoding:
Text File  |  2004-02-21  |  12.4 KB  |  285 lines

  1. .topic howtoDown
  2. .title "How to download a site"
  3.  
  4. <br>
  5. <P>I am going to try to guide through the steps of downloading a site.<br>
  6.  
  7. <ul>
  8. <li>First of all you need a site to download, sounds pretty simple but
  9. without it we won't go far.<br><br>
  10. <li>Then click on the icon on the left, a dialog window will appear in which
  11. you can enter the url. If you had put the url in the clipboard before clicking
  12. on the dialog, you will see it in the entry, ready for downloading.<br><br>
  13. <li>If you click on the left button, the one with the 'Options' label, a 
  14. new dialog will appear, here you will be able to set the options for the 
  15. download. The available options are:<br><br>
  16. <a name=Options>
  17. <ul>
  18. <li><b>Links</b>
  19.     <ul>
  20.     <li><b>Up links</b> Check this option if you want to download links
  21.     that are above the one you entered. For example, if you entered the
  22.     url <b>http://www.somedomain.com/daily/monday/index.html</b>
  23.     and you only want to download the files under the <b>monday</b>
  24.     directory, then you have to uncheck this option.<br><br>
  25.     <li><b>Update</b> If you have already downloaded a site and now you want
  26.     to update with the changes made since the last time you downloaded it,
  27.     then check this option.<br><br>
  28.     <li><b>CGI</b> Check this option if you want Getleft to follow links to
  29.     CGI scripts, in practice, if you check it, Getleft will download links
  30.     that include '?' in the url.<br><br>
  31.     </ul>
  32. <li><b>Levels</b>
  33.     <ul>
  34.     <li><b>Levels</b> Here you can put the number of levels of recursion
  35.     that Getleft will search for files, for example, the url you entered is
  36.     level '0', the links in that page are level '1',.... The default, with
  37.     the option unchecked, is no limit.<br><br>
  38.     <li><b>External levels</b> Here you can set whether you want Getleft to
  39.     download links outsite the domain of the url you entered, for example, if
  40.     you entered <b>http://www.somedomain.com/daily/monday/index.html</b>,
  41.     should Getleft follow a link to
  42.     <b>http://www.anotherdomain.com/diary/january/index.html</b>?<br>
  43.     <p><img src=warning>It is very easy to download more than you want.  <br>  
  44.     </ul>
  45. <li><b>Filters</b>
  46.     <ul>
  47.     <li><b>Get map</b> If you check this option, Getleft will first download
  48.     all the Html pages in the site (or at least all that match the rest of
  49.     the options) and then show a dialog with all the links found so you can
  50.     choose which of them to download.<br><br>
  51.     <li><b>Only Html</b> If you only want to download the Html pages in the
  52.     site, check this option.<br><br>
  53.     <li><b>Choose Filter</b> Pressing this button you will be shown a dialog
  54.     in which you can choose the extension of the files you don't want to 
  55.     download.
  56.     </ul><br>
  57. <li><b>Images</b>
  58.     <ul>
  59.     <li><b>All</b> All images will be downloaded.<br><br>
  60.     <li><b>Only thumbnails</b> Only the thumbnails will be downloaded.<br><br>
  61.     <li><b>No thumbnails</b> and the opposite.<br><br>
  62.     </ul>
  63. </ul>
  64. <p><b>Save</b> makes the current options be the default options for Getleft
  65. and <b>Load</b> sets the current options to the default values.
  66. <p><b>Notes:</b>
  67. <ul>
  68. <li>When the dialog pops up it will keep the options of the last download.<br><br>
  69. <li>During a download you will be able to change the options by using the button
  70. with the hammer and wrench in the downloading window.<br><br>
  71. <li>You can also change the options of a site while it is in the queue, right
  72. click on it to choose the 'Change options' entry in the popup menu.<br><br>
  73. </ul>
  74.  
  75. <li>After setting the options you have to decide whether you want to start
  76. the download inmediately, or wait for a better time, whatever you choose, check
  77. the 'Start now' option accordingly.<br><br>
  78. <b>Note</b>
  79. <ul>
  80. <li>During a download you can enter more urls for future downloading, they will 
  81. be put in the queue no matter what the 'Start now' button says.<br><br>
  82. </ul>
  83.  
  84. <li>Now you have to choose where you want to save the downloaded site, choose
  85. a directory and click on 'Accept'.<br><br>
  86.  
  87. <li>Getleft will now download the url you entered, if the url is a Html page
  88. with links in it, you will now see a dialog with all the links that match the
  89. given options, here you can choose which of these links will be downloaded and
  90. which will be ignored.<br><br>
  91. <p>If you right-click in this dialog, a menu will appear to help you choose, you will
  92. also be able to change the downloading options, the links will change depending
  93. on them.<br><br>
  94. <p>It is possible that no links are found with the current options, right click
  95. on the dialog to change them.<br><br>
  96.  
  97. <li>Accept this dialog and you are done, Getleft will now download the site on
  98. its own. If you want to pause the download, or stop it before it is over,
  99. you can do it with the buttons in the downloading window.<br><br>
  100. <p>If you stop it, you will be asked if you want Getleft to keep the download
  101. in the queue to continue later.
  102.  
  103. </ul>
  104.  
  105. .topic howtoTwoSites
  106. .title "How to download two files simultaneously"
  107. <br>
  108. <p>The short answer is that you can't, not with Getleft.
  109.  
  110. <p>As usual the long answer is more complicated:
  111. <br><br>
  112. <ul>
  113. <li><p>If you want to download two sites at the same time, you can do it
  114. simply by running Getleft twice and downloading one site from each instance
  115. of the program.
  116.  
  117. <p>Eventually, I will release version 2.0 of Getleft that will be able to 
  118. download several sites simultaneously.
  119.  
  120. <p>'Eventually', by the way, is more than six months.
  121. <br><br>
  122. <li><p>But if you want to download more than one file from the same site at
  123. the same time, I am afraid you will have to use another program, I don't
  124. think Getleft will ever do that, as I don't think we have the right to
  125. monopolize servers, I mean, I don't want to turn Getleft into a one man
  126. slashdot effect.
  127. </ul>
  128.  
  129. <p>Besides, you must consider that the bandwidth your ISP allocates you
  130. is not going to grow because you are downloading more than one file. That
  131. means that it is only worth it if one of the servers you are downloading
  132. from is slow, otherwise all the files will download more slowly
  133. than they would if you were downloading only one and Getleft will take
  134. pretty much the same time anyway.
  135.  
  136. <p>If you disagree with what I just said, please, don't hesitate to
  137. let me know.
  138.  
  139. .topic howtoAuto
  140. .title "How to download all the sites in the queue"
  141. <br>
  142. <p>If you have several sites in the queue and you want Getleft
  143. to download them all without asking you any questions, you only
  144. have to:
  145. <ul>
  146. <p><li>Select the sites you want to download, in case you want
  147. to download them all, you can simply clear the current selection
  148. by pressing the 'Esc' key.
  149. <p><li>Click on the 'Automatic' button, the one with the two arrows.
  150. </ul>
  151. <p>Getleft will change the colour of the sites you selected and
  152. start downloading them all, one after the other.
  153. <p>If you want to stop Getleft, click on the 'Auto' button again,
  154. the current site being downloaded will keep being downloaded on
  155. manual mode.
  156.  
  157. .topic howtoDelay
  158. .title "How to program a delay"
  159. <br>
  160. <p>Imagine you want to download a site but not right now, maybe it is
  161. cheaper to do it at night, or maybe you get better speed at certain hours.
  162.  
  163. <p>So, how can you do it?
  164.  
  165. <p>It is quite simple really, you only have to:<br>
  166. <ul>
  167. <li>Click on the button with the hourglass icon.<br><br>
  168. <li>A dialog will appear with all the options you need (so if you think
  169. you need more options, it is just your imagination).<br>
  170. <ul>
  171. <li><b>Time section</b>: Here you have to set the time at which Getleft
  172. will start downloading and whether it will stop at a given time or 
  173. continue the download till it is complete.<br><br>
  174. <li><b>Stop section</b>: If you gave a time when to stop, you have to
  175. decide how Getleft will stop, either inmediately, after the current file is
  176. downloaded or after all the files in the current page are downloaded.<br><br>
  177. <li><b>Days section</b>: You can choose whether you want the download to happen
  178. only today or on the days of the week you choose.<br><br>
  179. </ul>
  180. <p><b>Notes:</B>
  181. <ul>
  182. <li><P><img src=warning>Getleft won't connect the computer to the Internet or
  183. disconnect when the downloading is done.<br><br>
  184. <li>Getleft will always start with the first url in the queue and go on 
  185. until the last one is done.<br><br>
  186. <li>If you choose a time to start earlier than the current one, Getleft will
  187. guess you mean the following day.<br><br>
  188. <li>If you close Getleft and run it again, Getleft will recalculate the
  189. downloading times.<br><br>
  190. <li><b>Q: I have already started downloading a site, can I tell Getleft to stop 
  191. at a given time?</b><br><br>
  192. A: I am afraid not, you will have to stop it, and then program
  193. Getleft to restart, for example, the following minute and stop whenever you want.
  194. (Okay, maybe you do need more options)<br><br>
  195. </ul>
  196.  
  197. .topic howtoProxy
  198. .title "How to configure a proxy"
  199. <br>
  200. <P>Look in the 'Tools' menu and click on the 'Configure proxy' entry, 
  201. a dialog box appears in which you can enter the address of your proxy. You
  202. can check the address in the configuration of your browser, failing that, you
  203. can ask your network administrator.
  204.  
  205. <p>If your proxy requires authentification you can enter your username and password,
  206. if you choose not to save the password you will be queried for it when Getleft
  207. tries to download a file for the first time.
  208.  
  209. <P><img src=warning>Getleft doesn't support authentification through Microsoft's
  210. NTLM protocol.
  211.  
  212.  
  213. .topic howtoOther
  214. .title "How to save space"
  215. <br>
  216. <h3>Purging files</h3>
  217.  
  218. <p>This option allows to recursively scan through a directory tree, deleting 
  219. files that match a certain pattern and substituting them with empty files with
  220. the same name.
  221.  
  222. <p>This is useful is a site takes more than a session to download. For example,
  223. imagine you use two computers, one with a fast, reliable or, at least, cheap
  224. Internet connection, like the computer at work or at college, and another one,
  225. your very own, without it. You can download the sites in the first one and 
  226. take them to the second, in floppies, Zips,... With this option you can free
  227. space in the first computer and Getleft, seeing that the file already exists,
  228. won't try to download it again.
  229.  
  230. <h3>Restoring original files</h3>
  231.  
  232. <p>As the files get changed to keep only relative paths, the original ones are
  233. kept with an '.orig' extension. This command deletes the new files and
  234. renames the original ones to their real name.
  235.  
  236. <p>This is useful, is you actually want to mirror a site. This program, though, is
  237. not a good tool for mirroring sites.
  238.  
  239. .topic howtoUpdate
  240. .title "How to update a former download"
  241. <br>
  242. <p>After finising a download, Getleft saves the url and the directory where you saved
  243. it, you can access this log by clicking in the button with the book icon.
  244. <p>If you double-click on one the urls, a popup dialog will appear giving you the choice
  245. between updating the site or simply downloading it again, which makes sense if you first change
  246. the downloading options or if you the stopped the download before it was completed.
  247. <p>If you right click on the url, a more complete menu will appear, to update, download,
  248. change options, change the local directory,...
  249. <p><img src=warning>This log only has space for 100 entries, after that the first one gets overwritten. If you
  250. don't want one url to be deleted, you can right-click on it and check the 'Do not erase' entry.
  251.  
  252. .topic howtoSingle
  253. .title "How to download a single file"
  254. <br>
  255. <p>If you just want to download a single file, like for example:
  256.  
  257. <p><b>http://www.somedomain.com/somedomain.tar.gz</b>
  258. <p>You only have to enter that url, Getleft will then save it into the directory
  259. you tell it, without the directory structure of the original site.
  260.  
  261. .topic howtoPage
  262. .title "How to download a single page with images"
  263. <br>
  264. <p>You only have to enter the URL of the page in the usual way, when
  265. the dialog to choose files appears, you use the buttons at the bottom
  266. to disable all files and then enable all image files.
  267. <p>Or if you want to do it in automatic mode, you set the 'Levels' option
  268. to '1', this will download the page and all the links in it, including images.
  269.  
  270. .topic howtoHelp
  271. .title "How to get help"
  272. <br>
  273. <P>Since you are already reading the manual, I am not going to tell you to
  274. do so, you can:<br>
  275.  
  276. <ul>
  277. <li>E-mail me: fandom@retemail.es, or better (like a lot better):<br><br>
  278. <li>Check the mailing list, you can subscribe and look up the archives
  279.     <a href="tcl:Ayuda::InvokeBrowser http://lists.sourceforge.net/lists/listinfo/getleftdown-user>here</a>.
  280.     <br><br>
  281. <li>Use the
  282. <a href="tcl:Ayuda::InvokeBrowser http://sourceforge.net/projects/getleftdown/">support page</a>,
  283. there you will find out how to report a bug, ask for support, ...
  284. </ul>
  285.